home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u258.dms / in.adf / UserDocs / Manual_Pages / List < prev    next >
Encoding:
Text File  |  1988-02-12  |  7.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      List(Rel2)             ARP User's    Manual            List(Rel2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       List - List contents of a directory
  10.  
  11.      SYNOPSIS
  12.       LIST DIR P=PAT/K DATES/S KEYS/S NODATES/S S/K    SINCE/K    SORT/S
  13.           TO/K UPTO/K QUICK/S
  14.  
  15.      DESCRIPTION
  16.       List displays    the contents of    a given    directory.  By
  17.       contents, we mean the    names of the subordinate files and
  18.       directories, not the file data.  Typing the List command by
  19.       itself with no parameters generates a    listing    of the current
  20.       directory.
  21.  
  22.      THE LISTING DISPLAY
  23.       List displays    your files and directories one per line, with
  24.       more information about each file displayed to    the right of
  25.       the filename.     The fields which may appear in    a Listed file
  26.       are
  27.  
  28.       name [KEY] size/type protection date time
  29.       :comment
  30.  
  31.       Methods are provided for getting a selective listing of
  32.       files, as well as suppressing/adding most of the above
  33.       display elements.  A description of each one of the above
  34.       elements is given below:
  35.  
  36.       Name:          The name of the file or directory.
  37.  
  38.       [KEY]:      This is the actual block number of the file
  39.               or directory block header.  This is not
  40.               displayed by default,    you must use the KEYS
  41.               switch to generate this element of the
  42.               listing.
  43.  
  44.       size/type:      This element gives the size of the file in
  45.               bytes, or the    string "empty" if the file is
  46.               empty. If this is a directory    and not    file,
  47.               then the type    of the file ("Dir") will
  48.               appear here.
  49.  
  50.       protection:      The protection bits of the current file, in
  51.               the order rwed.  If any of these is
  52.               disabled, a dash (-) will appear in its
  53.               place. rwed stand for    Read Write Execute and
  54.               Deletable.
  55.  
  56.       date time:      The date and time of the last    modification
  57.               to the file or directory.  The format    of the
  58.               date display is determined by    the value of
  59.               the environment variable dateformat.    These
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      List(Rel2)             ARP User's    Manual            List(Rel2)
  71.  
  72.  
  73.  
  74.               elements of the listing appear by default,
  75.               but may be selectively added or subtracted
  76.               by using the DATES NODATES keywords.
  77.  
  78.       comment:      The comment as set by    Filenote.  If no
  79.               Filenote exists, this    field will not be
  80.               displayed.  Note that    it is displayed    on a
  81.               line by itself, preceeded by a colon.
  82.  
  83.      SELECTIVE LISTING OF FILES
  84.       The methods described    in this    section    allow you to view a
  85.       portion of the files and directories on your disks. Ways
  86.       exist    to generate a list of files that conform to a certain
  87.       pattern, or that were    created/modified before    or after a
  88.       certain date.     You may also combine these options, for
  89.       example, you may get a list of all files which end in    .c and
  90.       were created or modified since a certain date. These options
  91.       are described    below:
  92.  
  93.       DIR -    List this directory instead of the current directory.
  94.           This parameter may be    a filename, in which case the
  95.           single file is shown.     You may also use any legal
  96.           ARP pattern in this position,    in which case the
  97.           files    and directories    listed will be those which
  98.           match    the pattern, if    any.  Note that    only the ARP
  99.           List has the capability, this    is beyond the original
  100.           BCPL List.
  101.  
  102.       PAT -    List only files    and directories    which match the
  103.           pattern. You must specify the    keyword    PAT or its
  104.           abbreviation P.  This    is no longer truly necessary
  105.           with the expanded capabilities of the    ARP List,
  106.           since    it is usually more convenient to simply
  107.           include the pattern in the directory specification
  108.           as described above.  It is included for BCPL
  109.           compatibility.
  110.  
  111.       S - This searches for    an occurance of    the substring anywhere
  112.           within the directory name or filename.  Think    of
  113.           this as a short form of "List    PAT *substring*" or a
  114.           long form of "List *substring*".  List will reject
  115.           any attempts to combine the use of PAT and S.
  116.           Wildcards in the initial DIR argument    override the S
  117.           argument.  Again, this is no longer truly needed,
  118.           but is included for compatibility with existing
  119.           batch    files.
  120.  
  121.       SINCE    - While    the pattern matching options above filter
  122.           files    and directories    on the basis of    their names,
  123.           this option, and the following UPTO option, filter
  124.           out files based on their last    modification date.
  125.           SINCE    displays only files which have been created or
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      List(Rel2)             ARP User's    Manual            List(Rel2)
  137.  
  138.  
  139.  
  140.           modified on or later than the    specified date.     All
  141.           older    files are not displayed.  You may specify the
  142.           date in the currently    defined    dateformat (see
  143.           Environment Variables) or you    may use    a word such as
  144.           SUNDAY, TODAY, YESTERDAY, etc.
  145.  
  146.       UPTO - The inverse of    SINCE, this option displays only files
  147.           whose    files and directories have been    modified or
  148.           created on or    before the specified date.  Files
  149.           younger than this date are not dispalyed. See    SINCE
  150.           for a    description of the date    format list expects.
  151.  
  152.      ADJUSTING THE DISPLAY
  153.       The options below allow you to alter the format of the
  154.       display listing, or to send it to another file or output
  155.       display device (that's usually a printer).
  156.  
  157.       TO - You can specify a file or a device you wish the listing
  158.           to be    sent to    using this keyword.  If    not specified,
  159.           the default of the current window will be used.
  160.  
  161.       DATES    - Forces date and time information to be displayed in
  162.           the current dateformat. This is the default.
  163.  
  164.       NODATES - Will not display time and date information,    only
  165.           the filename,    size, protection and comment fields
  166.           will be displayed.
  167.  
  168.       QUICK    - Displays only    the filename field, one    filename per
  169.           line.     You can combine this with other options such
  170.           as DATES and KEYS to selectively enable these
  171.           fields.
  172.  
  173.       KEYS - Displays the block number of each file    header or
  174.           directory header.
  175.  
  176.       SORT - Sorts the file    and directory names into ascending
  177.           alphabetical order.  Case is disregarded. Note that
  178.           this is an option available only with    the ARP    list.
  179.  
  180.      ENVIRONMENT VARIABLES
  181.       The ARP List uses the    same dateformat    variable as used by
  182.       the ARP Date command,    and in essentially the same way.  If
  183.       it is    not defined, or    if it has an illegal value, the
  184.       default AmigaDOS display and input is    used.  Otherwise, the
  185.       display and the input    of dates is determined as follows:
  186.  
  187.       0 - AmigaDOS format DD-MMM-YY.
  188.  
  189.       1 - International format YY-MM-DD.
  190.  
  191.       2 - U.S. format MM-DD-YY.
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 2/22/88)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      List(Rel2)             ARP User's    Manual            List(Rel2)
  203.  
  204.  
  205.  
  206.       3 - Canada DD-MM-YY
  207.  
  208.       If you prefix    the above numbers with a dash, then the
  209.       display of names like    TODAY, MONDAY, FUTURE, etc., will be
  210.       disabled and the format string as defined above will be used
  211.       exclusively. Note that this governs the format that List
  212.       expects as input as well as the format List uses for
  213.       display.
  214.  
  215.      EXAMPLES
  216.       List df1:*.c SINCE WEDNESDAY
  217.       Displays all files in    df1: ending with the characters    "*.c"
  218.       who were modified later than TUESDAY at 00:00    hours.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 2/22/88)
  262.  
  263.  
  264.  
  265.